home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 7 / Apprentice-Release7.iso / Source Code / C / Applications / Python 1.4 / Python 1.4 source / Demo / README-Mac next >
Encoding:
Text File  |  1996-08-27  |  3.6 KB  |  88 lines  |  [TEXT/R*ch]

  1. Notes on using the Demo code on the mac.
  2. ----------------------------------------
  3. These notes were written by Jack on 17-Mar-96, using a version
  4. slightly newer than Python 1.3.2.
  5.  
  6. First and foremost: this code has only been tested lightly on the Mac.
  7. Most of it was initially written with Unix in mind. Some of the modules
  8. here will not work as expected.
  9.  
  10. Second and also foremost: there are more (mac-specific) demos and even
  11. some documentation (gasp!) in the Mac:Demos folder.
  12.  
  13. Some (but not all) modules will execute a test- or demo-routine if
  14. run standalone (i.e. double-clicked or dragged to python on the mac).
  15. However, to be able to actually *see* the output produced you will have
  16. to press <option> when dragging (or immedeately after double-clicking),
  17. otherwise Python will immedeately exit after successfully executing the
  18. test-code.
  19. Also, tests that need command-line arguments will not work with 1.3.2 or
  20. earlier.
  21.  
  22. Here are some more notes, on a per-directory basis:
  23.  
  24. classes: 
  25.   Dbm will not work, due to upper- and lowercase being similar for
  26.   the MacOS file system. It might work if you rename it.
  27. cwilib:
  28.   These modules should work, but the example program "cwilib" stopped
  29.   working because the CWI library catalog has been redone and the program
  30.   cannot parse the new format menus.
  31. dns:
  32.   These work. The test code doesn't work unless your python allows you
  33.   to specify command-line args. The classes themselves should work regardless.
  34. embed:
  35.   This has not been tested on the mac.
  36. mac:
  37.   These work, obviously:-)
  38. md5test:
  39.   Works (but the confidence test needs the ability to specify command-line args).
  40. pdist:
  41.   According to Guido these should work, but I didn't have enough time to find
  42.   out how...
  43. rpc:
  44.   These don't work currently. The problem appears to be minor, time.time()
  45.   returns a value (on the mac) that is too large to represent in an integer.
  46.   Maybe someone can fix this. Running these tests, by the way, is a bit of
  47.   a black art:
  48.   - option-start the script
  49.   - Select "enter interactive mode upon script completion"
  50.   - Wait for the script to finish (doing nothing)
  51.   - import sys, set sys.argv to whatever you want
  52.   - test()
  53. scripts:
  54.   A lot of these are unix-only, but some work on the Mac:
  55.   fact.py - works as expected
  56.   markov.py - works if you can specify command-line args.
  57.   morse.py - doesn't work currently, check out the version in Tools:bgen:snd.
  58.   pi.py - works
  59.   primes.py - works
  60.   update.py - sort-of works, but the input file syntax (with : as field
  61.       separator) is clumsy on the mac.
  62.   unbirthday.py - Works, option-start it and tell it to keep the output window
  63.       open on termination.
  64. socket:
  65.   Since mactcp doesn't support IP multicast the radio suite (broadcast, radio,
  66.   mcast) don't work.
  67.   echosvr.py - works.
  68.   finger.py - works, specify "@host" as command line.
  69.   ftp.py - works (specify host at command line). See the ftp client in Lib for
  70.       a better implementation.
  71.   gopher.py - almost works: it calls os.popen() to pipe text files to "more".
  72.       This is easily fixed, and the rest appears to work.
  73.   telnet.py - does not work, since it uses posix.fork(). Fixed versions are
  74.       welcomed.
  75.   throughput.py - sort-of works, but crashes at the end
  76.   udpecho.py - works, needs command line args.
  77. stdwin:
  78.   Apparently stdwin stopped working under MacPython at some point. If someone
  79.   cares: drop me a note and I will investigate.
  80. tkinter:
  81.   Not fully tested yet. Matt's demos will not work on the mac, probably,
  82.   due to names longer than 32 chars. Some of Guido's scripts appear to work.
  83. www:
  84.   These appear to use os.popen() to start a pager at various places. They
  85.   might be made to work with not too much difficulty, though.
  86.  
  87.   
  88.